home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / zmdm.zoo / zmdm.doc < prev    next >
Text File  |  1991-04-27  |  33KB  |  861 lines
  1.     zmdm.doc, v1.8 ++jrb
  2.  
  3.                 ACKNOWLEDGEMENTS
  4.  
  5.     ZMDM was derived from rz/sz for Unix  posted by 
  6.     Chuck Forsberg (...!tektronix!reed!omen!caf ). We
  7.     thank him for his excellent code, and for giving
  8.     us permission to use and distribute his code and
  9.     documentation.
  10.  
  11.     The code for detecting baud rate at startup is courtesy
  12.     of Brian Katzung (katzung@laidbak.UUCP). Thanks very
  13.     much!
  14.  
  15.     Andy Nicola did a lot of testing of the new features.
  16.     Thank You very much!
  17.  
  18.     Thanks to the many users on the net who wrote in.
  19.  
  20.     Thanks to Howard Chu (hyc@math.lsa.umich.edu) for his diffs
  21.     for overscan support and flow control option.
  22.  
  23.     Thanks to Bill Silvert (silvert@cs.dal.ca) and users of his
  24.     board for their enthusiastic support, and for testing various
  25.     buggy versions.
  26.  
  27.     It is possible to run @38.4K or higher baud rates, the changes
  28.     for this are simple. however, not all ST's run reliably at those
  29.     rates, so i left those options out.
  30.  
  31.     The phones module is totally compatible with our earlier program
  32.     xmdm, so phone directories created with xmdm can be used with zmdm.
  33.  
  34. ----------------------------------------------------------------------------
  35.     Enhancements since V1.8
  36.         o added duplex toggle to menu.
  37.         o cleanup the proto. now works fine with GEnies zmodem
  38.           download option.
  39.  
  40.     Enhancements since V1.7
  41.         o changes send CPS reporting. send report a block as
  42.           it begins to transmit it now. the cps includes read time
  43.           but not the write time of the receiver (so the two should
  44.           never be the same).
  45.         o quickly tried receive with GEnie and CompuServe
  46.         o fixed up sz binary mode. (thanks lars!)
  47.         o Complete protocol overhaul: brought it upto the latest
  48.           version i could find (05/25 version of unix rzsz). Now
  49.           supports RLE.
  50.         o fixed up Txwindow. i had broken it horribly,
  51.         o pulled out obuf support. it just caused problems, did
  52.           not gain anything at all. (the real gain comes from
  53.           sz streaming, and not by increasing the rs232 output
  54.           queue buffer size).
  55.         o only tested with gcc v1.37.1 (i dont intend to test the
  56.           others as i dont have them loaded on my HD anymore (and
  57.           i refuse to run off floppies!). however i was careful
  58.           not to break anything, but one never knows! As noted
  59.           below Alcyon is not supported any more).
  60.  
  61.     Enhancements since V1.68
  62.         o Alcyon C is no longer supported, nor is the old (V1.X)
  63.           Dlibs.
  64.         o Fixed up send not streaming. This was mainly due to
  65.           incorrect coding of Rxbuflen and related parameters
  66.           in sz.c.
  67.         o Cleaned up the code a bit.
  68.         o Protocol update to track Chuck F.'s changes in unix rzsz.
  69.         o merged Howard Chu's diffs for Overscan support
  70.           (not tested: #define OVERSCAN in config.h for support).
  71.         o merged Howards flow control diff. #define FLOW_CTRL
  72.           in config.h for flow control support.
  73.         o merged Howards HIBAUD diffs. I cant get this to work properly.
  74.  
  75.           Big thanks for Howard for his efforts!
  76.  
  77.     Enhancements since V1.67
  78.         o CPS reporting has changed. cps now is the effective
  79.           cps, on receive it includes the time to write the file.
  80.           on send it is the file send time (including read time).
  81.           note: on send the effective cps can be higher than the
  82.           baud rate can possible send. this discrepancy is because
  83.           of buffering. Also note, with some cpu accelarators in
  84.           this seems to come out to be a totally wild # (for
  85.           example i have seen this with early versions of
  86.           JRI's jato board )
  87.         o increased send buffer size
  88.         o minor bug fixes
  89.  
  90.     Enhancements since V1.64
  91.         o Updated protocol
  92.         o fixed some long/short int problems (due to strlen being
  93.           size_t for gcc lib)
  94.         o cursor is not turned on automatically. if you are running
  95.           this from the desktop and want the cursor turned on,
  96.           name the executable files with .tos or .ttp extensions.
  97.             o hi-rez toggle is preserved (ie: if you changed it
  98.               within zmdm, it is restored on exit).
  99.           Note: autowrap, and screen color inversion are not
  100.           preserved on purpose. if you want to change that
  101.           just look in main.c.
  102.  
  103.         o Bug: still does not understand the concept of
  104.           daylight saving time, so the St files will be
  105.           an hour behind when downloaded.
  106.           (also note: there are some versions of this program
  107.            munged by someone else, floating around on various BBS
  108.            that totaly screw up date/time/protection. Settle only
  109.            for the origonal!)
  110.         o Newer versions of TurboSt seem to live well with
  111.           the 50 line mode. QuickSt also seems to be fine.
  112.  
  113.     Enhancements since V1.64:
  114.         o accept an optional command line arguement for
  115.           default phone directory file name. If not found
  116.           or is not specified, then it looks for the 
  117.           environment variable "PHONE". If found it will
  118.           use it, otherwise the first time it tries to
  119.           use a phone directory, it'll prompt for a filename.
  120.         o Stderr now should go to screen. This fix is in the
  121.           gnu library and not in zmdm per se. (this also
  122.           will enable people to run the standalone programs
  123.           from flash etc). This program is supposedly incompatible
  124.           with Shadow. I dont have shadow, so i dont know what the
  125.           incompatibilities are, however this program uses standard
  126.           Tos calls for everything, and works under all versions
  127.           of Tos, so i suspect the problem is with Shadow.
  128.         o check in under RCS (internal change).
  129.  
  130.     Enhancements since V1.62:  (last Usenet release).
  131.  
  132.         o Now looks for environment variable "PHONE"
  133.           for default phone directory file name. If
  134.           found it will be opened.
  135.  
  136.         o Gnu C compiler added. Requires V1.35 or better.
  137.  
  138.     Enhancements since V1.2:
  139.     
  140.         o Some cleanup, moved common things around.
  141.           Some cosmetic additions.
  142.  
  143.         o MWC 3.0 compatible. The sample MW makefiles
  144.           reflect the setup required for MWC  V 3.0.6.
  145.  
  146.         o Manx Aztec C compatible. Tested with V 3.6a
  147.           of the compiler. Produces the smallest code
  148.           of all the compilers tested. See config.h,
  149.           makefile.man and makefman.sta.
  150.           CAUTION: for MegaST and 4Meg ST owners--
  151.             The Manx Version will not work correctly
  152.           for you due to a bug in the start up file
  153.           -- we are still trying to figure out exactly
  154.           what the problem is!
  155.  
  156.         o Auto Baud Rate detection on startup:
  157.           Previously ZMDM would set the baud rate
  158.           to a compile time configurable rate on
  159.           startup (it needed to know the baud rate
  160.           to determine its default packet size). Thanks
  161.           to code contributed by Brian Katzung, now it
  162.           detects the baud rate on startup.
  163.           Of course you can set the baud rate
  164.           within ZMDM (by hitting '<HELP>'  'b' ).
  165.  
  166.         o Compile time option to use all available memory
  167.           as recv/send buffer. See DYNABUF, LEAVEALONE and
  168.           MINACC preprocessor symbols in config.h. If you
  169.           prefer to use a fixed size buffer, this is still
  170.           possible by not #define'ing DYNABUF and setting
  171.           BBUFSIZ. MegaST OK - thanks Andy Nicola.
  172.  
  173.         o Stand Alone versions of RZ and SZ can be made
  174.           by compiling the sources with the preprocessor
  175.           symbols 'STANDALONE' #define'ed. See the makefile
  176.           'MAKEFILE.STA' for more details.
  177.           Stand Alone versions DO NOT do any command line
  178.           argument expansions for wild cards or directories
  179.           (unlike the integrated ZMDM).
  180.           Stand Alone versions tested from within Gulam,
  181.           Flash and Intersect. Thanks to Andy Nicola for
  182.           testing these features.
  183.  
  184.         o Remote versions of ZMDM, RZ and SZ can be made by
  185.           compiling the sources with the preprocessor symbol
  186.           'REMOTE' #define'ed. A remote version listens and
  187.           does all its I/O thru the serial port. Of course
  188.           it has to be fired up from console. One of our
  189.           area BBS's provides this as a D/L option, where
  190.           the BBS program execs a remote ZMDM, and one you exit
  191.           you return back to the BBS program.
  192.  
  193.             o Added -B (note: uppercase B) option to both RZ and SZ.
  194.           the -B function is a binary mode override, that disregards
  195.           the extension when deciding the transfer mode. This is
  196.           useful when say you are backing up your whole disk
  197.           to say a Unix host. (backup the exact image of the files),
  198.           or doing St-to-St type transfers.
  199.         
  200.         o Now compatible with the PD DLIB library. The
  201.           pre-processor symbol DLIBS must be defined. Only
  202.           tested with the Alcyon version of the